Qu’est-ce que l’accès API et pour quoi l’utilise-t-on ?

L’API (Application Programming Interface) d’Enlighten permet aux applications mobiles, aux outils de gestion d’immeuble et à d’autres logiciels d’accéder aux données de performances du système d’Enlighten et de les utiliser.

Par défaut, tous les systèmes dans Enlighten autorisent l’accès API. Néanmoins, un propriétaire de système peut gérer les paramètres API de son système et désactiver cette fonction, ou annuler l’accès à une application particulière.

Une application est autorisée à accéder aux données de performance du système quand :

les paramètres API d’un système sont activés ;
une application demande l’accès API au propriétaire de système ;
le propriétaire de système donne un accès API à l’application.

Gérer l’accès API

Pour activer ou désactiver l’accès API, allez sur la page Paramètres () et faites défiler vers le bas jusqu’aux Paramètres API dans le panneau Paramètres de confidentialité.
Décochez la case près de Autoriser l’accès API…. pour empêcher l’accès, ou cochez la case pour l’autoriser.
Cliquez sur Enregistrer.

Pour voir les permissions d’accès API, cliquez sur l’onglet Compte et faites défiler vers le bas jusqu’à Accès API.
API_Enlighten_Mgr

Pour voir quelles applications disposent de l’accès API au système, cliquez sur Afficher les applications avec un accès API.

Pour retirer l’accès à une application particulière, cliquez sur Annuler l’accès près du nom de l’application.

Pour les professionnels ayant des capacités de gestion du parc, vous pouvez aussi cliquer sur Afficher les systèmes qui autorisent l’accès API.

Accorder l’accès API

Si vous êtes propriétaire de système, une application demande l’accès API par le biais d’un lien comme celui-ci, que le lien soit dans un e-mail ou intégré à l’application elle-même :

https://enlighten.enphaseenergy.com/app_user_auth/new?app_id=1234567890000

Pour accorder l’accès API :

Cliquez sur le lien qui vous est présenté. Cela vous redirigera vers Enlighten ; vous pourriez devoir vous connecter.
Une page d’accès comme celle-ci s’affichera. Lisez la description de l’application si vous le souhaitez.
Cliquez sur Oui, autoriser l’accès.